From b86dbcf47bd0c65fe6c4e24f6301f2cfe2845685 Mon Sep 17 00:00:00 2001 From: "Karl O. Pinc kop@karlpinc.com" Date: Tue, 4 Aug 2026 20:19:54 +0000 Subject: [PATCH] Reference build_sightings() in SIGHTING_CONTROL docs --- doc/src/functions/sighting_controls.m4 | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/src/functions/sighting_controls.m4 b/doc/src/functions/sighting_controls.m4 index 119fbaa..44c6da4 100644 --- a/doc/src/functions/sighting_controls.m4 +++ b/doc/src/functions/sighting_controls.m4 @@ -43,6 +43,10 @@ searched. The SIGHTING_CONTROLS row's other columns control which rows are examined when searching. +For each individual, for each day, the |function_build_sightings| +function examines each SIGHTING_CONTROLS' row, ordered by +|SIGHTING_CONTROLS.Step| value, lowest number first. + .. caution:: The rows in SIGHTING_CONTROLS are referenced, by @@ -56,6 +60,9 @@ examined when searching. The recommended practice is to change SIGHTING_CONTROLS only when the |SIGHTINGS| table is empty. + Alternately, begin a transaction, make the desired changes to + SIGHTING_CONTROLS, use |function_build_sightings| to rebuild the + entire |SIGHTINGS| table, and commit the transaction. The SIGHTING_CONTROLS table contains many columns that correspond with the columns of SokweDB's tables. -- 2.34.1